HostMonitor's Main Page Log Analyzer
Version 4.03
Copyright (c) 2000-2004 KS-Soft
  What's New What's New    Copyright/License/Warranty Copyright/License/Warranty    Download HostMonitor Download    Registration Information Buy Now   

Main Page

HostMonitor
Log Analyzer
HML Manager
RMA for Windows
RMA for Unix
RMA Manager
Telnet Service
Web Service
Replicator

IP-Tools

Log Analyzer is an auxiliary application for HostMonitor, it is included into Advanced Host Monitor package. Professional and Enterprise licenses for Advanced Host Monitor already include a license for Log Analyzer. Holders of a Lite or Standard licenses may buy an additional license for Log Analyzer separately.


Intro    Menu    Full screen chart    Report Manager    Options    Scripts    System Requirements    Price

As you know HostMonitor is able to log test results into a log file. Log Analyzer is a graphical tool that visualizes the log data. It parses the contents of a log file and presents the data as a variety of charts representing different test statistics. Log Analyzer may analyze all types of log files: HTML, Text, and DBF log files. In a second, administrator can get a snap shot of the host performance over a period of days or even months.
Several examples of the reports:
  Example #1
  Example #2
  Example #3

Features:

  • Log Analyzer allows you to check information individually for each test;
  • It allows to analyze several log files at once;
  • For each test you can view a graphical chart;
  • The highly flexible Report Manager allows you to create and customize reports to your taste in a variety of ways;
  • Scripting support allows you to create reports automatically.

Main menu:

File
Load -Loads and analyzes specified log file
Append -Appends information from specified log file into the current data set
Refresh -Rereads all loaded log files
Print -Prints information from an active pane
Exit -Closes Log Analyzer
 
Search
Find -Searches for specific text, and highlights the first occurrence
Search again -Repeats the last search (starts from current position)
Filter -Date filter allows you to analyze log file(s) for specified period of time
 
View
Toolbar -Shows/hides toolbar
Log pane -Shows/hides log pane
Chart pane -Shows/hides chart pane
 
Chart
Full screen -Displays full screen version of a chart
Copy image to Clipboard-Copies a chart as an image into the clipboard
Print -Brings up a Print Preview dialog that allows you to print a chart
 
Reports
<list of the reports> -Generates HTML report using selected report profile
Report Manager -Brings up Report Manager dialog allowing you to modify and create new report profiles
 
Options
Interface -Displays Options dialog with interface related settings
Chart -Displays Options dialog allowing you to modify settings of the the full screen chart
Reports -Displays Options dialog with the settings related to the reports
 
Help
Help -Displays Help
Home page -Starts default web browser, opens home page of the Log Analyzer on www.ks-soft.net
WWW Forum -Starts default web browser, opens web forum on www.ks-soft.net
Support -Allows you to send e-mail to our tech support staff
About -About Log analyzer
License -License information and registration options


Full screen chart:

To display a chart in a full screen window, choose the item "Full screen chart" from the popup menu (this menu appears when you right-click in the Log Analyzer window).

Starting from version 3.50 Log Analyzer allows zooming in and out over the selected area of a chart. To zoom in on a chart area, hold the left mouse button and drag mouse down and right. You will see a rectangle around the selected area. Release the left mouse button to zoom in. You may continue zooming again and again.
To restore (undo) the zoom, drag a rectangle in the opposite direction (up and left).

After you right click the chart you may change upper and lower limits of the vertical and horizontal axis using "Set bounds" popup menu item. In the Chart Bounds dialog use an "Interval to display" parameter to set what time period needs to be displayed on the graph (horizontal axis). Use "Bounds to display" parameter to set the limits for "Reply" value mapping onto a graph (vertical axis).

Test logged time (from-till) - shows the whole period of time for which records in the log are available
Interval to display (from-till)  - specifies the period of time to display on the screen
Test "Reply" value (min-max) - minimum and maximum values of the "Reply" field in the log file
Bounds to display (from-till) - specifies the lower and upper limits of the vertical axis. The user may change them to display the "Reply" values with a different scale.

There are following commands available in the chart's popup menu:
  3D - enable/disable 3D effects
  Statistics - show/hide semi-transparent panel with statistical information about the test
  Options - brings up Options dialog
  Set bounds - brings up Chart Bounds dialog (allows you to set lower and upper limits both for vertical and horizontal axis)
  Adjust - sets the lower and upper limit of a vertical axis so that the "Reply" values of the selected time interval are fit on the screen
  Copy image to Clipboard - copies a chart as an image into the clipboard
  Save to file - saves an image of the chart as a bitmap (BMP) file
  Print - brings up Print Preview dialog
  Close - closes full screen chart (returns to Log Analyzer main window)

To close the full screen chart and return to Log Analyzer main window, press [ESC] or [Enter] or select "Close" menu item after the right click on the chart.


Report Manager:

The highly flexible Report Manager allows you to create and customize reports in a variety of ways. Within each profile you may set the following parameters:

Filter

Display following fields
The listbox on the left in the Report Manager dialog window contains the list of fields that you may include into the report (e. g., test name, test method, average reply, downtime, etc.). Click on the check box next to a field name to mark/unmark the item. Use "Mark all" button to select all available fields, use "Unmark all" button to deselect all items, use "Invert selection" to invert selection for the list.

Include following tests
The list in middle selects the test types to include into the report (e. g., all tests except Ping and CPU Usage tests). Click on the check box next to a field name to mark/unmark the item. Use "Mark all" button to select all available fields or use "Clear all" button to deselect all items. "Invert selection" option is also available.

Skip following tests
Use the listbox on the right to exclude some specific tests from the report.

Chart

Chart settings
Log Analyzer can create chart for each test. Choose one of the following options and specify width & height of the images.

  • Do not create charts
  • Create charts, add links to the report
  • Create charts, insert images into the report
    Charts are stored as an images in GIF file format.

    File

    File
    By default Log Analyzer saves all reports into one directory (you can specify that directory in the Options dialog), and uses the name of the profile as a file name (with HTM extension). But you can specify another file name by choosing the "Put report into particular file" option and providing a path and name of the file.

    Overwrite prompt
    With this option enabled Log Analyzer will ask for confirmation if the report file that is going to be created already exists.

    Resolve macros
    If you enable this option a date macro variables may be specified in the destination file name. Log Analyzer will interpret text between the '%' in the file name as a macro variable, where 'DD' represents the day of the month, 'MM' - the month, 'YY' - the year (2 last digits), 'YYYY' - the year.
    This allows creating file names by a template such as one of these:
      C:\HostMonitor4\Reports\%DDMMYY%-rep.htm
      C:\HostMonitor4\Reports\%YYYY\DD-MM%.htm

    Templates

    Use external header
    Use external footer
    Using these options you can provide an HTML files that will be used as a header and/or footer for the report. Mark this option only if you want to change the standard header or footer of the report. In HostMonitor's directory "Examples\LAReports\" you can find an example of the header and footer (the files: footer1.htm, header1.htm).
    In the header/footer file you can use macro variables to show the current date and time. You may select different colors and so on. Below is a list of the macro variables that may be used in an external header/footer:
    Variable Description
    %Date% current date
    %Time% current time
    %DateTime% current date & time
    %BGColor% background color
    %TextColor% text color
    %LinkColor% hypertext link color
    %VLinkColor% visited link color
    %ALinkColor%   active link color

    Use template for the table
    By using this option you may provide a file with HTML code that will be used to represent each test within the report. Of course each test has unique parameters so you have to use macro variables (which represent different test parameters) in the template. For example: if you want to create the report that will display a table with an average reply value for each test, use simple template with 2 variables:
    "<tr><td>%TestName%</td><td>%AverageReply%</td></tr>" (an HTML code for the header of a table should be contained in the header file). In HostMonitor's directory "Examples\LAReports\" you will find an example of such template (file templ1.htm).
    Below is a list of the macro variables that can be used in a template:
    Variable Description
    %TestName% name of the test
    %TestMethod% test method
    %Period% represents the whole time interval of the test log
    %AverageReply% the average value of the results obtained
    %MinReply% the minimum value of the results obtained
    %MaxReply% the maximum value of the results obtained
    %AliveRatio% Percentage of "Good" test results
    %DeadRatio% Percentage of "Bad" test results
    %UnknownRatio% Percentage of "Unknown" test results
    %DetailedLogFile%   when this variable occurs in the table template, Log Analyzer creates HTML file that contains all check results for the test. It substitutes this variable with a corresponding file name.
    So, if you want to provide detailed log file for each test, use HTML code such as "<a href="%detailedlogfile%">".
    %ImageFile% when this variable occurs in a template Log Analyzer creates GIF image that represents the test results and inserts the file name of this image file instead of the variable.
    So, if you want to insert images into the report, use HTML code like "<img src="%imagefile%">".
    If you want to insert links to images into the report, use code like "<a href="%imagefile%">".

    Several examples of the reports:
      Example #1
      Example #2
      Example #3

    Create reports
    Report Manager dialog contains several buttons that allow you to generate reports right away:

  • Current profile: creates report using current profile (the one you are currently editing)
  • Selected profiles: creates reports for marked profiles
  • All profiles: creates reports for all profiles


    Options:




    Interface page

    Colors
    Offers a choice of colors for the text, background and a chart pane.

    Show Toolbar
    Shows/hides the toolbar
    Show Log pane
    Shows/hides the log pane
    Show Chart
    Shows/hides the chart pane

    Grid
    By using this option you may specify a number of vertical and horizontal lines of the grid in a chart pane. You may also enable or disable grid in the log pane.

    Use fixed date&time format
    By default Log Analyzer gets current Windows regional settings at startup and uses these parameters until you change Windows settings and restart application. You may use this option to define the date & time formats (e.g. DD/MM/YYYY h:mm:ss AMPM). In this case, Log Analyzer will use the specified formats overriding the system settings.
    BTW: Changing the date format does not affects analyzing of the DBF and HTML log files. Log Analyzer is able to analyze these log files correctly regardless of the date & time settings. However this option can be useful to analyze text log files or html log files that were created by older versions of HostMonitor.


    Chart page

    You may chose the color scheme for the full screen chart on this page.


    Reports page

    Default destination folder
    Provide a path to the default destination folder for the reports. If this parameter is empty, Log Analyzer will use the directory where it was started from. In Report Manager you may specify different destination directory for some of the reports.

    Folder for images & detailed logs
    Here you may specify a path to a separate folder where auxiliary images and detailed log files will be stored. If you specify the relative path, Log Analyzer will use "Default destination folder"+"Folder for images" as a destination path. E.g. if you have defined "C:\HostMonitor4\Reports\" as a default folder and "Images\" as folder for images, then images and detailed logs will be stored in "C:\HostMonitor4\Reports\Images\" directory.

    Use macros
    If you enable this option a date macro variables may be specified in the path. Log Analyzer will interpret the text between the '%' of the path string as a macro, where 'DD' represents the day of the month, 'MM' - the month, 'YY' - the year (2 last digits), 'YYYY' - the year.
    For example the use of such a template will create a separate folder every day:
      C:\HostMonitor4\Reports\%DD-MM-YY%\
      C:\HostMonitor4\Reports\%YYYY\DD-MM%\

    Color palette
    You may customize color scheme for the HTML reports. The following elements have customizable colors (you may change both fore- and background colors):

  • underlaying layer;
  • table header;
  • test items;
  • system messages;
  • HTML links;
  • Visited HTML links;
  • Active HTML links;
    To change the color of an element, click on an element that you want to change. Use right-click to change its background color, and left-click to change the text color.
    The colors of the chart (GIF images) may be changed on Chart page of the Options dialog.


    Scripts:

    Log Analyzer 4.0+ supports scripts. Scripts allow you to generate reports automatically by schedule (e.g. using standard NT scheduler). Log Analyzer Script file (default extension .LAS) is a simple text file that contains commands for the application. You can create and edit script file using any text editor (e.g. notepad).

    Some common rules:

  • You can put only one command in each line
  • Comments: The program ignores all strings with a semicolon (;) as the 1st character
  • Commands: commands are case insensitive (e.g. "Load" and "LOAD" means the same)
  • When you provide a log file name or a date filter you can use date macro variables. Log Analyzer will interpret the text between '%' in the parameter as a date macro variable, where 'DD' represents the day of the month, 'MM' - the month, 'YY' - the year (2 last digits), 'YYYY' - the year.

    List of the commands:
    CommandParameter(s)Description
    Load <log file name> Loads and analyzes specified log file
    Append <log file name> Appends information from specified log file into current data set
    Filter <start date>   <end date>   Applies filter that determines what time period Log Analyzer should include into the reports. Format of the <start date> & <end date> is: DDMMYYYY
    CreateReport "<report profile name>" Creates report using specified report profile
    CreateSelectedReports   Creates reports for marked profiles (those that are marked in the Report Manager dialog)
    CreateAllReports Creates reports for all profiles

    Example of the script:
    ;------------------------------------------
    Load C:\HostMonitor4\logs\%YYYY%\log.htm
    Append C:\HostMonitor4\logs\privatelog1.htm
    Append C:\HostMonitor4\logs\privatelog2.htm
    Filter %01MMYYYY% %30MMYYYY%
    CreateReport "HTTP tests (charts)"
    CreateReport "HTTP tests (no charts)"
    Createreport "Template1"
    ;------------------------------------------

    To execute a script, you should start Log Analyzer with the following command line parameter "-script:<name of script file>". There is also an optional parameter "-log:<name of the log file>". With this optional parameter Log Analyzer will record information about script execution and about errors in the script (if any) into the specified file.
    Example: LogsMan.exe   -script:reports.las   -log:scriptlog.txt


    Minimum system requirements

    • Windows 95 (OSR2), 98, ME, NT 4.0, Windows 2000, or XP
    • Internet Explorer 4.0 or higher (application can work without IE but help system will not be available)
    • 2 Mb of free disk space
    • Minimum screen resolution: 800 x 600
    Recommended:
    • Internet Explorer 5+
    • Screen resolution: 1024 x 768 or higher

    How much does it cost?

    When you purchase an Advanced Host Monitor PROFFESIONAL or ENTERPRISE edition you will get the license for Log Analyzer at no cost. Otherwise the license costs $45. You can order Log Analyzer using credit card, Switch and Solo debit cards, check/money order or wire transfer. If you are concerned about submitting your order and/or credit card information online, you may register the Log Analyzer via phone, fax or postal mail.
    Details..